home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / tbbs / statx200.zip / STATICS.DOC < prev    next >
Text File  |  1996-06-06  |  34KB  |  858 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.         ┌─────────────────────────────────────────────────────────────┐
  12.         │ ███████╗ ████████╗  █████╗  ████████╗ ██╗  ██████╗ ███████╗ │
  13.         │ ██╔════╝ ╚══██╔══╝ ██╔══██╗ ╚══██╔══╝ ██║ ██╔════╝ ██╔════╝ │
  14.         │ ███████╗    ██║    ███████║    ██║    ██║ ██║      ███████╗ │
  15.         │ ╚════██║    ██║    ██╔══██║    ██║    ██║ ██║      ╚════██║ │
  16.         │ ███████║    ██║    ██║  ██║    ██║    ██║ ╚██████╗ ███████║ │
  17.         │ ╚══════╝    ╚═╝    ╚═╝  ╚═╝    ╚═╝    ╚═╝  ╚═════╝ ╚══════╝ │
  18.         └─────────────────────────────────────────────────────────────┘
  19.  
  20.  
  21.                         -   TBBS Dayfile analyzer   -
  22.  
  23.                                 Version 2.00
  24.  
  25.                     copyright 1996 (c) by De Belder Frans
  26.                      Shareware - Free distribution only !
  27.  
  28.                               QuickBasic used
  29.  
  30.  
  31.  
  32.                    ────────────────────────────────────────
  33.                     Documentation for STATICS version 2.00
  34.                    ────────────────────────────────────────
  35.  
  36.  
  37.            Sorry, for the bad language... Hope you can live with it?
  38.  
  39.  
  40.        STATICS  V 2.00                                  TABLE OF CONTENTS
  41.      ──────────────────────────────────────────────────────────────────────
  42.  
  43.  
  44.  
  45.  
  46.  
  47.          INTRODUCTION .............................................. p - 1
  48.  
  49.          STATICS FILES ............................................. p - 2
  50.          LICENSE AGREEMENT ......................................... p - 2
  51.          REGISTRATION .............................................. p - 2
  52.  
  53.          INSTALLATION .............................................. p - 3
  54.          UPGRADING FROM V 1.X ...................................... p - 3
  55.          WHAT WILL STATICS DO ...................................... p - 3
  56.  
  57.          STATICS.CFG FILE .......................................... p - 4
  58.  
  59.          KEYS AND SYNTAX ........................................... p - 5
  60.                [area] .............................................. p - 5
  61.  
  62.                [baud] .............................................. p - 6
  63.                [date] .............................................. p - 6
  64.  
  65.                [errorfile] ......................................... p - 7
  66.                [graphic] ........................................... p - 7
  67.  
  68.                [lines] ............................................. p - 8
  69.                [logfile] ........................................... p - 8
  70.  
  71.                [proglist] .......................................... p - 9
  72.                [protocol] .......................................... p - 9
  73.  
  74.                [qsodownload] ....................................... p - 10
  75.                [qsoupload] ......................................... p - 10
  76.  
  77.                [samename] .......................................... p - 11
  78.                [tbbslist] .......................................... p - 11
  79.  
  80.                [time] .............................................. p - 12
  81.  
  82.          THE [TBBSLIST] LAYOUT FILE ................................ p - 13
  83.          LIST OF VARIABLES USED IN THE [TBBSLIST] FILE ............. p - 13
  84.  
  85.          EXAMPLE OF LAYOUT FILE .................................... p - 14
  86.  
  87.          MAKING A HEADING FOR [PROGLIST] ........................... p - 15
  88.          WHAT HAVE WE PLANNED FOR THE FUTURE ....................... p - 15
  89.          HISTORY ................................................... p - 15
  90.  
  91.          APPENDIX - ERROR CODES .................................... p - 16
  92.          STATICS  V 2.00                                            p - 1
  93.      ──────────────────────────────────────────────────────────────────────
  94.  
  95.      ┌──────────────┐
  96.      │ INTRODUCTION │
  97.      └──────────────┘
  98.  
  99.  
  100.      STATICS analyses the dayfile.lst (see manual pag. 2-23 of your TBBS
  101.      manual), and turn it into useful information like statistics and
  102.      graphics.
  103.      
  104.      STATICS has almost NO LIMITS !
  105.  
  106.      STATICS will work with EVERY length of dayfile.
  107.      We have tested the program with dayfiles of 8 megabyte.
  108.      You can make your own statistics and graphics and you
  109.      define what, where and how they shall appear.
  110.  
  111.      STATICS show you the information like defined in a layout file.
  112.      ( see [TBBSLIST] )
  113.      This layout file can be in ASCII or ANSI format.
  114.      You can use a unlimited number of layout files !
  115.      You can make as much statistics as you like !
  116.  
  117.      STATICS can place each layout file in an other directory.
  118.  
  119.      STATICS can show the 36 collected figures in each list.
  120.      
  121.      STATICS support 99 lines, and can trace more than 2 billion downloads !
  122.      
  123.      STATICS makes a list of downloaded files and sorts it according the
  124.      number of times it was downloaded. ( see [PROGLIST] )
  125.  
  126.      STATICS don't stop if an error occur in the dayfile !
  127.      This errors are mentioned in a error list ( STATICS.ERR )
  128.  
  129.      STATICS don't 'hang-up' your computer, even if there is an error.
  130.      This give you the possibility to run STATICS from a batch file.
  131.        ( *** ONLY FOR REGISTERED USERS *** )
  132.      
  133.      STATICS make all/every line graphics of your BBS, and placed it where
  134.      you like it. ( *** ONLY FOR REGISTERED USERS *** )
  135.      UNREGISTERED USERS can make ONLY graphics for line 0 (local logins)
  136.  
  137.      STATICS is not expensive !
  138.  
  139.      FREE UPGRADE ONLY FOR REGISTERED USERS OF STATICS !
  140.                VERSION 3 IS SOON TO COME !
  141.      
  142.      For registration of STATICS, read and print the REGISTRA.FRM !
  143.          STATICS  V 2.00                                            p - 2
  144.      ──────────────────────────────────────────────────────────────────────
  145.  
  146.      ┌───────────────┐
  147.      │ STATICS FILES │
  148.      └───────────────┘
  149.  
  150.      The following files are included in STATX200.ZIP :
  151.  
  152.      FILE_ID.DIZ   > Description file
  153.      FOLDMONY.FRM  > Don't take a change !
  154.      REGISTRA.FRM  > NO REGISTRATION, NO UPGRADES and NO SUPPORT.
  155.                      Fill it out and mail it. Thanks !
  156.      SAMPLE_1.CFG  > Example of ASCII layout file. MODIFY !
  157.      SAMPLE_1.HDR  > Example of ASCII header file. MODIFY !
  158.      SAMPLE_2.CFG  > Example of ASCII layout file. MODIFY !
  159.      SAMPLE_3.CFG  > Example of ASCII layout file. MODIFY !
  160.      SAMPLE_4.CFG  > Example of ANSI layout file.  MODIFY !
  161.      STATICS.CFG   > Statics configuration file. MODIFY!
  162.      STATICS.DAT   > Statics datafile
  163.      STATICS.DOC   > This file. Documentation for STATICS.
  164.      STATICS.EXE   > Statics V 2.00
  165.      STATICS.OVL   > Statics graphics module.
  166.      OUTPT_EX.ZIP  > Some output samples from a BBS.
  167.  
  168.  
  169.      ┌───────────────────┐
  170.      │ LICENSE AGREEMENT │
  171.      └───────────────────┘
  172.  
  173.  
  174.      STATICS is distributed as ShareWare and it is not free !
  175.  
  176.      You are welcome to post this program on your BBS, give copies to
  177.      friends, so long as the ENTIRE STATICS package is distributed,
  178.      including this documentation, WITHOUT any changes maked.
  179.  
  180.      You may not omit or modify any part of the STATICS package.
  181.  
  182.      No fee may be charged, except the actual cost of providing these
  183.      copies.
  184.  
  185.      IN NO CASE, you may distribute a 'registration key'.
  186.  
  187.      You may use STATICS only for a evaluation period of 30 days.
  188.      After this period, you MUST register STATICS or you must remove it
  189.      from your computer.
  190.  
  191.      You use STATICS at YOUR OWN RISK !
  192.  
  193.      ┌──────────────┐
  194.      │ REGISTRATION │
  195.      └──────────────┘
  196.  
  197.  
  198.      For registration of STATICS, read and print the REGISTRA.FRM ! !
  199.      
  200.      The Latest version of STATICS can be downloaded from the eSoft
  201.      support board (see your manual of TBBS for more info!).
  202.      You can also 'freq' the program with the magic name: STATICS
  203.      from FIDONODE: 2:292/818 (V34)
  204.  
  205.  
  206.          STATICS  V 2.00                                            p - 3
  207.      ──────────────────────────────────────────────────────────────────────
  208.  
  209.      ┌──────────────┐
  210.      │ INSTALLATION │
  211.      └──────────────┘
  212.  
  213.  
  214.      Make a directory ( e.g. STATICS ) and put all the files in this
  215.      directory.
  216.      Edit STATICS.CFG and all the examples and modify them.
  217.      Run STATICS.
  218.       
  219.      
  220.      ┌──────────────────────┐
  221.      │ UPGRADING FROM V 1.x │
  222.      └──────────────────────┘
  223.  
  224.      Copy the next files in the STATICS directory :
  225.      
  226.                            STATICS.EXE
  227.                            STATICS.OVL
  228.                            STATICS.DAT
  229.  
  230.      Delete the STATICS.ERR file.
  231.  
  232.      Edit the STATICS.CFG file for adding the graphic commands.
  233.  
  234.  
  235.      ┌──────────────────────┐
  236.      │ WHAT WILL STATICS DO │
  237.      └──────────────────────┘
  238.  
  239.  
  240.      STATICS create the following files :
  241.  
  242.         ■  File(s) with information about the BBS ( see [TBBSLIST] )
  243.            There can be showen 36 collected figures in each list.
  244.            STATICS need a layout file, in which you specify what comes where.
  245.            This layout file can be an ASCII or ANSI file.
  246.  
  247.  
  248.         ■  Sorting lists of TOP - downloads. ( see [PROGLIST] )
  249.            All kinds of TOP lists are possible.
  250.            If you want a heading, you must make an ASCII or ANSI file for
  251.            that heading.
  252.  
  253.            
  254.         ■  File(s) with graphics of all/every line(s). ( see [GRAPHIC] )
  255.            This file(s) give you an overview of the inlogs on your BBS.
  256.  
  257.            
  258.         ■  STATICS.ERR  error file.  ( see [ERRORFILE] )
  259.            This file is always created. Every time STATICS run, it writes
  260.            to that file.
  261.            If [errorfile] is enabled in STATICS.CFG, each error that occurs
  262.            in the dayfile, or each error in STATICS, is reported.
  263.          STATICS  V 2.00                                            p - 4
  264.      ──────────────────────────────────────────────────────────────────────
  265.  
  266.      ┌──────────────────┐
  267.      │ STATICS.CFG FILE │
  268.      └──────────────────┘
  269.  
  270.  
  271.      The configuration file STATICS.CFG contains all the information
  272.      needed for a correct working of STATICS.
  273.      This file must be modified for personal use.
  274.      This is very simple. Use a common ASCII editor ( e.g. EDIT ).
  275.  
  276.      The file must obey the following rules:
  277.  
  278.       ■ Every lines first readable character that is NOT a '[' is
  279.         being seen as a comment.
  280.  
  281.       ■ Every command ('KEY') must be between '[ ]' characters, and must
  282.         obey the right syntax.
  283.  
  284.       ■ Every 'KEY' not contained in the list below is been seen as comment.
  285.  
  286.       ■ Before and after every 'KEY' there can be one or more spaces.
  287.  
  288.       ■ Every 'KEY' line can not contain comments !
  289.          STATICS  V 2.00                                            p - 5
  290.      ──────────────────────────────────────────────────────────────────────
  291.  
  292.      ┌──────────────────┐
  293.      │ KEY'S AND SYNTAX │
  294.      └──────────────────┘
  295.  
  296.      ──────────────────────────────────────────────────────────────────────
  297.      [area]            path   =    name
  298.      ──────────────────────────────────────────────────────────────────────
  299.  
  300.         path    : The path(s) as used in the dayfile.
  301.                   The paths must not be given complete.
  302.                   STATICS searches for a similarity.
  303.                   Make this path as long as necessary.
  304.                   When the path is blanco, all not mentioned 'areas'
  305.                   will get the description which are mention in 'name'
  306.                   Put the path with the longest number of characters first,
  307.                   and with the smallest number of characters last in the
  308.                   STATICS.CFG file
  309.         name    : The text that will be placed after the filename in the
  310.                   TOP files lists.
  311.  
  312.      ■  Description
  313.  
  314.         Attach in the TOP lists after the name of the file the text
  315.         contained in 'name'.
  316.  
  317.         
  318.      ■  Example
  319.  
  320.         [area]      c:\tbbs\downl\virus  =  Virus scanners
  321.  
  322.      ■  Remark
  323.  
  324.         [area] may used more than once.
  325.  
  326.      ■  Limit   : 300
  327.          STATICS  V 2.00                                            p - 6
  328.      ──────────────────────────────────────────────────────────────────────
  329.      ──────────────────────────────────────────────────────────────────────
  330.      [baud]          rate  =  b:nn
  331.      ──────────────────────────────────────────────────────────────────────
  332.  
  333.         rate    : The baud rate as used in the dayfile.
  334.         b:nn    : Name of a variable, used for various baudrates.
  335.                   The name MUST always begin with a 'b:' followed
  336.                   by a number of 00 to 99.
  337.                   GIVE EVERY BAUDRATE ANOTHER NUMBER !
  338.        
  339.      ■  Description
  340.  
  341.         Let STATICS know which baudrate must be count, and which baudrate
  342.         is join to which variable.
  343.         
  344.      ■  Example
  345.  
  346.         [baud]     300 = b:01
  347.         [baud]    1200 = b:02
  348.         [baud]    9600 = b:16
  349.  
  350.      ■  Remark
  351.  
  352.         [baud] may used more than once.
  353.         
  354.      ■  Limit   :   99
  355.  
  356.      ──────────────────────────────────────────────────────────────────────
  357.      [date]        DD-MM-YY
  358.      ──────────────────────────────────────────────────────────────────────
  359.  
  360.      ■  Description
  361.  
  362.         DD-MM-YY : The date format like it appear in dayfile.
  363.  
  364.      ■  Example
  365.  
  366.         [date]  DD-MM-YY
  367.         [date]  MM/DD/YY
  368.        
  369.      ■  Remark
  370.  
  371.         [date] may appear ONLY ONCE in STATICS.CFG !!
  372.         USE THE RIGHT DATE SEPARATOR !
  373.  
  374.          STATICS  V 2.00                                             p - 7
  375.      ──────────────────────────────────────────────────────────────────────
  376.      ──────────────────────────────────────────────────────────────────────
  377.      [errorfile]
  378.      ──────────────────────────────────────────────────────────────────────
  379.  
  380.      ■  Description
  381.  
  382.         Makes a errorfile of all the errors found during the run of STATICS
  383.         If [errorfile] is not mention in STATICS.CFG, than don't report the
  384.         founded errors.
  385.         Every run of STATICS is ALWAYS reported in STATICS.ERR.
  386.  
  387.      ■  Remark
  388.  
  389.         No path needed.
  390.         STATICS.ERR appear always in the STATICS directory.
  391.         STATICS.ERR become always created. Every run of STATICS is reported.
  392.         
  393.      ──────────────────────────────────────────────────────────────────────
  394.      [graphic]     type x  line nn - mm = path1
  395.      [.]           heading 1
  396.      [..]          heading 2
  397.      ──────────────────────────────────────────────────────────────────────
  398.  
  399.         type x       : The sort of graphic that must be created.
  400.                        Provisional always type 1
  401.         line nn - mm : The line number from - up to
  402.         path1        : Full path and name where the file with graphics must
  403.                        be placed.
  404.         [.]          : First heading line above graphic. If no text wanted,
  405.                        leave this line blanc.
  406.         [..]         : Second heading line above graphic. If no text wanted,
  407.                        leave this line blanc.
  408.      
  409.     ■   Description
  410.  
  411.         Makes graphics of type x ( provisional always type 1 ) from line nn
  412.         up to line mm and place this graphic in 'path1'.
  413.         Put at the top of graphic heading '[.]' and on next line
  414.         heading '[..]'.
  415.                      
  416.      ■  Example
  417.  
  418.         [graphic]  type 1  line 1 - 2 = c:\tbbs\info\grafiek1.txt
  419.         [.]        Users inlog line 1 and 2
  420.         [..]       from this month
  421.  
  422.      ■  Remark
  423.  
  424.         The key [graphic] exist ALWAYS of three lines, and so it
  425.         must be through [.] and [..]. This three lines MUST be there!
  426.         The headings appear in the middle of the line.
  427.         [graphic] may be used more than once.
  428.  
  429.         UNREGISTERED USERS CAN MAKE ONLY GRAPHICS FOR LINE 0 (LOCAL LINE) !!
  430.         
  431.      ■  Limit   : No limit !
  432.          STATICS  V 2.00                                            p - 8
  433.      ──────────────────────────────────────────────────────────────────────
  434.      ──────────────────────────────────────────────────────────────────────
  435.      [lines]    n
  436.      ──────────────────────────────────────────────────────────────────────
  437.  
  438.      ■  Description
  439.  
  440.         n       : amount of lines used on your BBS (maximum 99).
  441.  
  442.      ■  Example
  443.  
  444.         [lines]           99
  445.  
  446.      ■  Remark
  447.  
  448.         [lines] MUST APPEAR ONLY ONCE in STATICS.CFG !!
  449.  
  450.      ■  Limit   :  99
  451.  
  452.      ──────────────────────────────────────────────────────────────────────
  453.      [logfile]     path
  454.      ──────────────────────────────────────────────────────────────────────
  455.  
  456.      ■  Description
  457.  
  458.         path    : The complete path and name of the logfile.
  459.  
  460.      ■  Example
  461.  
  462.         [logfile]    c:\tbbs\log\dayfile.lst
  463.  
  464.      ■  Remark
  465.  
  466.         [logfile] MUST APPEAR ONLY ONCE in STATICS.CFG !!
  467.          STATICS  V 2.00                                            p - 9
  468.      ──────────────────────────────────────────────────────────────────────
  469.      ──────────────────────────────────────────────────────────────────────
  470.      [proglist]        path1  =  path2  =  count
  471.      ──────────────────────────────────────────────────────────────────────
  472.  
  473.         path1    : Full path and name where file must be placed.
  474.         path2    : Full path and name of heading file. If not mentioned, no
  475.                    heading appear in the TOP list.
  476.         count    : Amount of programs that must be counted in that Top Files
  477.                    list. If not mentioned, all the files will be counted.
  478.  
  479.      ■  Description
  480.  
  481.         Makes a TOP list of downloaded files. If you wanted a heading, you
  482.         must make a header file. This file can be a ASCII or ANSI file.
  483.         
  484.      ■  Example
  485.  
  486.         [proglist]  c:\tbbs\info\top20.txt = c:\tbbs\info\head_1.txt = 20
  487.         [proglist]  c:\tbbs\info\topall.txt = c:\tbbs\info\head_2.ans =
  488.  
  489.      ■  Remark
  490.  
  491.         You MUST ALWAYS use two '=' characters behind [proglist], even you
  492.         don't fill in a heading or count.
  493.         Path2 and count may be blanc.
  494.         [proglist] can be used MANY times. As many as needed !
  495.  
  496.      ■  Limit    : No limit !
  497.  
  498.      ──────────────────────────────────────────────────────────────────────
  499.      [protocol]      prot = p:nn
  500.      ──────────────────────────────────────────────────────────────────────
  501.  
  502.         prot    : The protocol as used in the logfile.
  503.         p:nn    : Name of a variable, which is attached to a protocol.
  504.                   The name of the variable must ALWAYS beging with a 'p:'
  505.                   followed by a number of 00 tot 99.
  506.                   GIVE EVERY PROTOCOL ANOTHER NUMBER !!
  507.                   
  508.      ■  Description
  509.  
  510.         Let STATICS know which protocol must be count and what variable
  511.         hold that count.
  512.  
  513.      ■  Example
  514.  
  515.         [protocol]   zmodem  =  p:01
  516.         [protocol]   xmodem  =  p:99
  517.         [protocol]   sealink =  p:00
  518.                    
  519.      ■  Remark
  520.  
  521.         [protocol]  may used more than once.
  522.                    
  523.      ■  Limit   :    99
  524.          STATICS  V 2.00                                            p - 10
  525.      ──────────────────────────────────────────────────────────────────────
  526.      ──────────────────────────────────────────────────────────────────────
  527.      [qsodownload]     path
  528.      ──────────────────────────────────────────────────────────────────────
  529.  
  530.      ■  Description
  531.  
  532.         path     : The path as used in the logfile, where QWK packets
  533.                    are stored for download. See QSO manual page 10.
  534.  
  535.      ■  Example
  536.  
  537.         [qsodownload]   c:\tbbs\qsotemp
  538.  
  539.      ■  Remark
  540.  
  541.         [qsodownload] may appear ONLY ONCE in STATICS.CFG !!
  542.  
  543.      ──────────────────────────────────────────────────────────────────────
  544.      [qsoupload]       path
  545.      ──────────────────────────────────────────────────────────────────────
  546.  
  547.      ■  Description
  548.  
  549.         path     : The path as used in the logfile, where QWK packets
  550.                    are stored for upload. See QSO manual page 10.
  551.  
  552.      ■  Example
  553.  
  554.         [qsoupload]   c:\tbbs\qsotemp
  555.  
  556.      ■  Remark
  557.  
  558.         [qsoupload] may appear ONLY ONCE in STATICS.CFG !!
  559.          STATICS  V 2.00                                            p - 11
  560.      ──────────────────────────────────────────────────────────────────────
  561.      ──────────────────────────────────────────────────────────────────────
  562.      [samename]        name1   =   name2
  563.      ──────────────────────────────────────────────────────────────────────
  564.      
  565.         name1    : Name of the file that you like to change (count only!).
  566.         name2    : The new name for that file.
  567.  
  568.      ■  Description
  569.  
  570.         Let STATICS think that 'name2' is the name of 'name1'.
  571.         Handy to count different files as though it have one filename.
  572.  
  573.      ■  Example
  574.  
  575.         [samename]     softbox.qw  =  softbox.qwk
  576.  
  577.      ■  Remark
  578.  
  579.         'name1' must not be complete. In this example, all files that have
  580.         the same name for the first 10 characters will be changed in the
  581.         second name.
  582.         So, SoftBox.qw0, softbox.qwk etc. will be also counted.
  583.         'name1' must not be complete.
  584.  
  585.      ■  Limit    :    99
  586.  
  587.      ──────────────────────────────────────────────────────────────────────
  588.      [tbbslist]     path1  =  path2
  589.      ──────────────────────────────────────────────────────────────────────
  590.      
  591.          path1   : Full path and name of the layout file. When in the
  592.                    same directory as STATICS.EXE, no path is needed.
  593.                    The layout file is a ASCII or ANSI file containing
  594.                    the necessary information to make a file with system
  595.                    information.
  596.          path2   : Full path and name of the output files.
  597.  
  598.  
  599.      ■  Description
  600.  
  601.         Makes an information list of the BBS. A layout file is needed.
  602.         This can be an ASCII or ANSI file.
  603.         
  604.      ■  Example
  605.  
  606.         [tbbslist]  c:\tbbs\system.lst = c:\tbbs\sysop\system.txt
  607.         [tbbslist]  login.lst  = c:\tbbs\user\login.txt
  608.  
  609.      ■  Remark
  610.  
  611.         [tbbslist] can be used MANY times. As many as needed !
  612.         
  613.      ■  Limit    : No limit !
  614.          STATICS  V 2.00                                            p - 12
  615.      ──────────────────────────────────────────────────────────────────────
  616.      ──────────────────────────────────────────────────────────────────────
  617.      [time]        HH:MM:SS
  618.      ──────────────────────────────────────────────────────────────────────
  619.  
  620.      ■  Description
  621.  
  622.         HH:MM:SS : The time format like it appear in dayfile.
  623.  
  624.      ■  Example
  625.  
  626.         [time]     HH:MM:SS
  627.  
  628.      ■  Remark
  629.  
  630.         [time] MUST APPEAR ONLY ONCE in STATICS.CFG !!
  631.         USE THE RIGHT TIME SEPARATOR !
  632.          STATICS  V 2.00                                            p - 13
  633.      ──────────────────────────────────────────────────────────────────────
  634.  
  635.      ┌────────────────────────────┐
  636.      │ THE [TBBSLIST] LAYOUT FILE │
  637.      └────────────────────────────┘
  638.  
  639.      STATICS makes it possible to create your own layout for the output
  640.      file. You determine what will be seen and what text will explain the
  641.      results in that file. STATICS makes use of variables to store the
  642.      results.
  643.      The only thing you must do is create a layout file. In that file you
  644.      can place comments and on the right place, you put the corresponding
  645.      variable.
  646.      This variable become replaced with the right result.
  647.      Each variable is 6 characters long. The maximum value is 999999.
  648.      The subjoined list gives all the legal variables.
  649.  
  650.  
  651.      ┌────────────────────────────────────────────────┐
  652.      │ List of variables used in the [tbbslist] file: │
  653.      └────────────────────────────────────────────────┘
  654.  
  655.      [l:nn]     Login's on line nn. Possible lines from [l:00] until [l:99]
  656.      [toli]     Total amount of logins
  657.      [loli]     Local logins
  658.      [ghli]     Ghost tasks logins
  659.      [usli]     User logins
  660.      [newu]     New user logins
  661.      [nolo]     Normal logoffs
  662.      [tllo]     Time limit logoffs
  663.      [cllo]     Carrier losses logoffs
  664.      [tocl]     total carrier losses
  665.      [tbbs]     TBBS disconnects
  666.      [invp]     Invallid password
  667.      [pswc]     Password changed
  668.      [chrq]     Chat request with sysop
  669.      [msge]     Message entered
  670.      [msgd]     Message deleted
  671.      [qstu]     QSO total uploads
  672.      [qsnu]     QSO normal uploads
  673.      [qsau]     QSO aborted uploads
  674.      [qstd]     QSO total downloads
  675.      [qsnd]     QSO normal downloads
  676.      [qsad]     QSO aborted downloads
  677.      [sysu]     System startups
  678.      [syso]     System shutoffs
  679.      [exev]     External events
  680.      [ghta]     Ghost tasks
  681.      [toup]     Total uploads
  682.      [noup]     Normal uploads
  683.      [abup]     Aborted uploads
  684.      [todl]     Total downloads
  685.      [nodl]     Normal downloads
  686.      [abdl]     Aborted downloads
  687.      [p:nn]     protocol nn
  688.      [b:nn]     baudrate nn
  689.      [otpr]     Other protocols (than defined in STATICS.CFG)
  690.      [otba]     Other baudrate's (than defined in STATICS.CFG)
  691.          STATICS  V 2.00                                            p - 14
  692.      ──────────────────────────────────────────────────────────────────────
  693.  
  694.      ┌────────────────────────┐
  695.      │ EXAMPLE OF LAYOUT FILE │
  696.      └────────────────────────┘
  697.  
  698.  
  699.    Create your own output file with Statics, this is only one example!
  700.  
  701.   ┌──────────────────────────────────────────────────────────────────────────┐
  702.   │  Logins on line  1 ...... : [l:01]  BOCA 28.8 modem                      │
  703.   │  Logins on line  2 ...... : [l:02]  BOCA 28.8 modem                      │
  704.   │  Logins on line  3 ...... : [l:03]  ZyXEL 19.2 modem                     │
  705.   │  Logins on line  4 ...... : [l:04]  ZyXEL 19.2 modem                     │
  706.   │  Logins on line 16 ...... : [l:16]  USR 28.8 modem                       │
  707.   │  Logins on line 32 ...... : [l:32]  HAYES V.34 modem                     │
  708.   │  Logins on line 64 ...... : [l:64]  SUPRA 28.8 modem                     │
  709.   │  Logins on line 96 ...... : [l:96]  TBBS 2.3  The Best BBS Software!     │
  710.   │  Logins on line 99 ...... : [l:99]  TBBS 3.0   <g>                       │
  711.   ├────────────────────────────────────┬─────────────────────────────────────┤
  712.   │  Total Logins ........... : [toli] │ Normal logoffs .......... : [nolo]  │
  713.   │  Local Logins ........... : [loli] │ Time limit logoffs ...... : [tllo]  │
  714.   │  Ghost Logins ........... : [ghli] │ Carrier losses logoffs .. : [cllo]  │
  715.   │  User Logins ............ : [usli] │ Total carrier losses .... : [tocl]  │
  716.   │  New users .............. : [newu] │ TBBS disconnects ........ : [tbbs]  │
  717.   ├────────────────────────────────────┼─────────────────────────────────────┤
  718.   │  Invallid password        : [invp] │ Chat request (with sysop) : [chrq]  │
  719.   │  Password changed         : [pswc] │                                     │
  720.   ├────────────────────────────────────┼─────────────────────────────────────┤
  721.   │  Messages entered ....... : [msge] │ System startup .......... : [sysu]  │
  722.   │           deleted ....... : [msgd] │ System shutoff .......... : [syso]  │
  723.   │  QSO total uploads ...... : [qstu] │ External events ......... : [exev]  │
  724.   │      normal uploads ..... : [qsnu] │ Ghost tasks ............. : [ghta]  │
  725.   │      aborted uploads .... : [qsau] │                                     │
  726.   │      total downloads .... : [qstd] │                                     │
  727.   │      normal downloads ... : [qsnd] │                                     │
  728.   │      aborted downloads .. : [qsad] │                                     │
  729.   ├────────────────────────────────────┼─────────────────────────────────────┤
  730.   │  Total uploads .......... : [toup] │ Total downloads ......... : [todl]  │
  731.   │  Normal uploads ......... : [noup] │ Normal downloads ........ : [nodl]  │
  732.   │  Aborted uploads ........ : [abup] │ Aborted downloads ....... : [abdl]  │
  733.   ├────────────────────────────────────┼─────────────────────────────────────┤
  734.   │  ZMODEM  Downloads ...... : [p:01] │ 0000 BAUD Logons ........ : [b:01]  │
  735.   │  XMODEM  Downloads ...... : [p:02] │  300 BAUD Logons ........ : [b:02]  │
  736.   │  YMODEM  Downloads ...... : [p:03] │ 1200 BAUD Logons ........ : [b:03]  │
  737.   │  KERMIT  Downloads ...... : [p:04] │ 2400 BAUD Logons ........ : [b:04]  │
  738.   │  SEALINK Downloads ...... : [p:05] │ 4800 BAUD Logons ........ : [b:05]  │
  739.   │  LOCAL   Downloads ...... : [p:06] │ 9600 BAUD Logons ........ : [b:06]  │
  740.   │                                    │  19K BAUD Logons ........ : [b:07]  │
  741.   │                                    │  28K BAUD Logons ........ : [b:11]  │
  742.   │                                    │  38K BAUD Logons ........ : [b:08]  │
  743.   │                                    │  57K BAUD Logons ........ : [b:09]  │
  744.   │                                    │ 115K BAUD Logons ........ : [b:10]  │
  745.   │                                    │                                     │
  746.   │  OTHER PROTOCOL ......... : [otpr] │ OTHER BAUDRATE .......... : [otba]  │
  747.   └────────────────────────────────────┴─────────────────────────────────────┘
  748.          STATICS  V 2.00                                            p - 15
  749.      ──────────────────────────────────────────────────────────────────────
  750.  
  751.      ┌──────────────────────────────────┐
  752.      │ MAKING A HEADING FOR  [PROGLIST] │
  753.      └──────────────────────────────────┘
  754.  
  755.  
  756.      If you want a heading in the TOP files listing, you must make a ASCII
  757.      or ANSI file.
  758.      STATICS take care that the right heading is placed in the right output
  759.      file.
  760.  
  761.  
  762.      ┌─────────────────────────────────────┐
  763.      │ WHAT HAVE WE PLANNED FOR THE FUTURE │
  764.      └─────────────────────────────────────┘
  765.  
  766.  
  767.      ■ OM loads
  768.      ■ Menus loaded
  769.      ■ More System graphics
  770.      ■ Q&A used, aborted etc.
  771.      ■ System performance
  772.      ■ System errors
  773.      ■ Text reading
  774.  
  775.        FREE UPGRADE ONLY FOR REGISTERED USERS OF STATICS !!!
  776.  
  777.  
  778.      ┌─────────┐
  779.      │ HISTORY │
  780.      └─────────┘
  781.  
  782.  
  783.      STATICS V 1.00     First version.
  784.  
  785.      STATICS V 1.10     If registration name longer than 25 characters,
  786.                         a 'bug' appear in the layout.
  787.                         Not published because version 2.00 came out.
  788.  
  789.      STATICS V 2.00     Error handling modified.
  790.                         STATICS.ERR layout modified.
  791.                         All errors are reported.
  792.                         Graphic module enclosed.
  793.                         Documentation modified.
  794.  
  795.  
  796.  
  797.      Questions or remarks ? Please contact: Frans De Belder 2:292/818
  798.                                         or: Rudi Breens     2:292/818
  799.          STATICS  V 2.00                                            p - 16
  800.      ──────────────────────────────────────────────────────────────────────
  801.  
  802.      ┌────────────────────────┐
  803.      │ APPENDIX - ERROR CODES │
  804.      └────────────────────────┘
  805.      
  806.      Error codes are in the first place meaned for debugging the program by
  807.      the author. Normaly there shall appear no error. ( I hope so )
  808.      Almost all the errors are syntax errors in the STATICS.CFG file.
  809.      It is a good idee to look from time to time to the STATICS.ERR file.
  810.      
  811.      Error codes are show as following :
  812.  
  813.                          error code : E 53 M 1020
  814.  
  815.      where   E 53    the errorcode  and     M 1020    the module.
  816.      
  817.      A few errors can be solved by yourself. Here is the list.
  818.  
  819.      ╔════════════════════════════════════════════════════════════════════╗
  820.      ║                  Error codes in STATICS.ERR                        ║
  821.      ╠════════════════════════════════╦═══════════════════════════════════╣
  822.      ║ E 5      Illegal function call ║   E 53     File not found         ║
  823.      ║ E 6      Overflow              ║   E 57     Device I/O error       ║
  824.      ║ E 7      Out of memory         ║   E 61     Disk full              ║
  825.      ║ E 11     Division by zero      ║   E 67     Too many files         ║
  826.      ║ E 14     Out of string space   ║   E 68     Device unavailable     ║
  827.      ║ E 24     Device timeout        ║   E 71     Disk not ready         ║
  828.      ║ E 25     Device fault          ║   E 72     Disk-media error       ║
  829.      ║ E 51     Internal error        ║   E 75     Path/File access error ║
  830.      ║ E 52     Bad filename          ║   E 76     Path not found         ║
  831.      ╚════════════════════════════════╩═══════════════════════════════════╝
  832.      
  833.                           
  834.      Most frequent errors
  835.      ────────────────────
  836.      
  837.      E 5  M 6091         error in [graphic] (look at STATICS.CFG)
  838.      E 52 M 2080         bad filename in [logfile] (look at STATICS.CFG)
  839.                          or [logfile] missing.
  840.      E 53 M 1000         STATICS.DAT not found (is it in the STATICS dir.?)
  841.      E 53 M 1010         STATICS.CFG not found (is it in the STATICS dir.?)
  842.      E 53 M 1020         [logfile] not found (look at STATICS.CFG)
  843.      E 53 M 1030         [proglist] not found (look at STATICS.CFG)
  844.      E 53 M 1040         [tbbslist] not found (look at STATICS.CFG)
  845.      E 76 M 1030         error in path [proglist] (look at STATICS.CFG)
  846.      E 76 M 2230         error in path [proglist] (look at STATICS.CFG)
  847.      E 76 M 6180         error in path [graphic] (look at STATICS.CFG)
  848.  
  849.      This error list is not complete but shows the most frequent errors.
  850.      If there appears an other error, or you found any 'bugs', please report
  851.      it and write a message to :
  852.  
  853.                Frans De Belder   FidoNode 2:292/818
  854.  
  855.      and report the error like it appear  ( E xx M xxxx ) in STATICS.ERR.
  856.  
  857.      Thanks for reading this file and enjoy STATICS.
  858.